package com.kakarote.hrm.service;

import com.alibaba.fastjson.JSONObject;
import com.kakarote.common.log.entity.OperationLog;
import com.kakarote.core.entity.BasePage;
import com.kakarote.core.entity.UploadEntity;
import com.kakarote.core.servlet.BaseService;
import com.kakarote.hrm.entity.BO.QueryRecruitUserPageListBO;
import com.kakarote.hrm.entity.PO.HrmRecruitUser;
import com.kakarote.hrm.entity.VO.RecruitUserVO;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;

/**
 * <p>
 * 招聘人员 服务类
 * </p>
 *
 * @author system
 * @since 2024-01-01
 */
public interface IHrmRecruitUserService extends BaseService<HrmRecruitUser> {

    /**
     * 添加招聘人员
     *
     * @param recruitUser 招聘人员
     * @return 操作日志
     */
    OperationLog addRecruitUser(HrmRecruitUser recruitUser);

    /**
     * 修改招聘人员
     *
     * @param recruitUser 招聘人员
     * @return 操作日志
     */
    OperationLog setRecruitUser(HrmRecruitUser recruitUser);

    /**
     * 获取招聘人员详情
     *
     * @param recruitUserId 招聘人员id
     * @return 招聘人员详情
     */
    RecruitUserVO queryById(Long recruitUserId);

    /**
     * 查询招聘人员列表
     *
     * @param queryRecruitUserPageListBO 查询条件
     * @return 分页结果
     */
    BasePage<RecruitUserVO> queryRecruitUserPageList(QueryRecruitUserPageListBO queryRecruitUserPageListBO);

    /**
     * 根据计划id查询所有招聘人员列表
     *
     * @param planId 计划id
     * @return 招聘人员列表
     */
    List<RecruitUserVO> queryByPlanId(Long planId);

    /**
     * 根据记录id查询所有招聘人员列表
     *
     * @param recordId 记录id
     * @return 招聘人员列表
     */
    List<RecruitUserVO> queryByRecordId(Long recordId);

    /**
     * 根据过程id查询所有招聘人员列表
     *
     * @param procesId 过程id
     * @return 招聘人员列表
     */
    List<RecruitUserVO> queryByProcesId(Long procesId);

    /**
     * 删除招聘人员
     *
     * @param recruitUserId 招聘人员id
     * @return 操作日志
     */
    OperationLog deleteRecruitUser(Long recruitUserId);

    /**
     * 批量删除招聘人员
     *
     * @param recruitUserIds 招聘人员id列表
     * @return 操作日志
     */
    OperationLog batchDeleteRecruitUser(List<Long> recruitUserIds);

    /**
     * 根据计划id删除所有招聘人员
     *
     * @param planId 计划id
     * @return 操作日志
     */
    OperationLog deleteByPlanId(Long planId);

    /**
     * 根据记录id删除所有招聘人员
     *
     * @param recordId 记录id
     * @return 操作日志
     */
    OperationLog deleteByRecordId(Long recordId);

    /**
     * 根据过程id删除所有招聘人员
     *
     * @param procesId 过程id
     * @return 操作日志
     */
    OperationLog deleteByProcesId(Long procesId);

    /**
     * 导出招聘人员
     *
     * @param response                   HTTP响应
     * @param queryRecruitUserPageListBO 查询条件
     * @throws IOException IO异常
     */
    void exportRecruitUser(HttpServletResponse response, QueryRecruitUserPageListBO queryRecruitUserPageListBO) throws IOException;

    /**
     * 下载导出模板
     *
     * @param response HTTP响应
     */
    void downloadExcel(HttpServletResponse response);

    /**
     * excel导入招聘人员
     *
     * @param file 文件对象
     * @return 导入结果
     */
    JSONObject excelImport(MultipartFile file);

    /**
     * 上传临时文件，此文件会七天后删除
     *
     * @param file    文件对象
     * @param batchId batchId
     * @return entity
     */
    UploadEntity uploadTempFile(MultipartFile file, String batchId);
}

